Release 10.1A: OpenEdge Getting Started:
Installation and Configuration

Editing the properties file

The Unified Broker properties file, ubroker.properties, stores the configuration definitions for all instances of the NameServer, and all instances of any AppServer, AppServer Internet Adapter, OpenEdge Adapter for SonicMQ, WebSpeed Transaction Server, and DataServer products that run on the same machine. Each configuration definition contains property settings, environment variables (to be set when the Unified Broker starts), and references to registry entries for each product instance. Because the same properties file stores configurations for several different products, some sections of the file are generic to several different product broker configurations.

There is one copy of this file for each OpenEdge installation. Thus, if you install the controlling NameServer on a separate machine from the Unified Broker product that it controls, the NameServer and Unified Broker product each have their own ubroker.properties file. For more information on the Unified Broker properties file, see the "Ubroker.properties file and product configurations" section.

Editing and validating the properties file

To edit the properties file directly, use a text editor such as vi or Notepad. Once you edit the properties file, use the NSCONFIG command to validate the NameServer configuration information in the file. If the file contains any other Unified Broker configurations, run the configuration validation utilities for those Unified Broker products to ensure that these configurations are still valid. For more information, see the "Ubroker.properties file and product configurations" section.

The NSCONFIG utility displays the property settings associated with a NameServer configuration and checks that the syntax and values are valid. You must run the NSCONFIG utility locally on the machine on which the NameServer is running. The utility does not run across the network.

For example, the following command validates the syntax and views the configurations of all NameServer instances defined within the test.properties file located in the current working directory:

nsconfig -propfile test.properties -validate

Once you have configured the controlling NameServer, you can configure your Unified Broker product components. You can configure each Unified Broker product much like the NameServer. For more information, see your product documentation.

For complete information about the syntax and the options you use to invoke the NSCONFIG utility, see Appendix C "Command and Utility Reference."